home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / amiutils / i_l / irit5 / readme.1st < prev    next >
Text File  |  1995-12-30  |  11KB  |  232 lines
  1. This file describes the steps need to be taken to compile this package
  2. under the different environments.
  3.  
  4. Join IRIT mailing list:        gershon@cs.technion.ac.il
  5. Mailing list:            irit-mail@cs.technion.ac.il
  6. Bug reports:            irit-bugs@cs.technion.ac.il
  7.  
  8. -----------------------------------------------------------------------------
  9.  
  10. OS2
  11. ---
  12.  
  13.    Edit the file makeflag.os2 in the main directory.
  14. Set all the variables to the correct path you would like the include
  15. files/libraries/binaries to be installed to.
  16.    Type 'make -f makefile.os2'. This should build the libraries
  17. (misc/cagd/prsr/graf) following by all the tools including the solid
  18. modeler itself - IRIT.
  19.  
  20.    Once everything built, change directory to the binaries directory. Edit
  21. all *.cfg configuration files and follow the instructions in them to configure
  22. the programs to your system.
  23.    On line help is saved in irit.hlp and is copied to the binaries
  24. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  25. to get a hardcopy manual for IRIT. Alternatively print 'irit.doc' which is
  26. a similar but plain text file.
  27.  
  28.    Each of the subdirectories illustrt/filters/poly3d-r/poly3d-h has a
  29. batch file called test-os2.cmd. Run them to test your new executables.
  30.   Note you will need a gif viewer for poly3d-r images and that test-os2.cmd on
  31. poly3d-h do require ???Drvs display device executable to display the hidden
  32. line removed results.
  33. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  34. There are quite a few other .irt files in that directory you may want to try.
  35. Make sure the IRIT_PATH environment variable is properly set as well as
  36. OS2IRIT and OS2IRIT_POS as described in the manual. You can run all
  37. these tests by executing 'make -f makefile.os2 test' from the main directory.
  38.  
  39.    Things to watch for:
  40.  
  41. * all the makefiles in the subdirectories source makeflag.unx via the line
  42.   'include ../makeflag.os2'. If your make support different include structure
  43.   or does not support it at all, you will have to change it or manually
  44.   substitute makeflag.unx content into the subdirectory makefiles.
  45. * poly3d-r requires gif_lib (see below) to build, a library that is not
  46.   provided with this package. You can ftp it separately (see below).
  47.   The poly3d-r renderer renders into 8 bit GIF images and results are
  48.   medium at best. Using the filter IRIT2RAY, use RAYSHADE which is far
  49.   superior and recommended.
  50.  
  51. -----------------------------------------------------------------------------
  52.  
  53. UNIX
  54. ----
  55.    Edit the file makeflag.unx in the main directory.
  56. Set all the variables to the correct path you would like the include
  57. files/libraries/binaries to be installed to. You will, at least, need to
  58. set SRC_DIR.
  59.   Select the correct compiler flags if your architecture exists there, by
  60. typing 'make -f makefile.unx' to get a list of supported platforms.
  61. Otherwise create a new entry in makeflag.unx flags for your system.
  62.    Type 'make -f makefile.unx xxxx', where xxxx is your platform. This
  63. should build the libraries (misc, cagd, prsr, etc.) following by all the
  64. tools including the solid modeller itself - IRIT.
  65.  
  66.    Once everything built, change directory to the binaries directory. Edit
  67. all *.cfg configuration files and follow the instructions in them to configure
  68. the programs to your system.
  69.    On line help is saved in irit.hlp and is copied to the binaries
  70. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  71. to get a hardcopy manual for IRIT. Alternatively print 'irit.doc' which is
  72. a similar but plain text file.
  73.  
  74.    Each of the subdirectories illustrt/filters/poly3d-r/poly3d-h has a batch
  75. file called test-unx. Run them to test your new executables by doing
  76. 'csh test-unx'. Note you will need a gif viewer for poly3d-r images and that
  77. test-unx on poly3d-h do require ???drvs display device executable to display
  78. the hidden line removed results.
  79. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  80. There are quite a few other .irt files in that directory you may want to try.
  81. Make sure the IRIT_PATH and IRIT_DISPLAY environment variables are properly
  82. set as described in the manual. You can run all these tests by executing
  83. 'make -f makefile.unx test' from the main directory. Optionally you might
  84. need to set the environment of IRIT_SERVER_PORT and IRIT_SERVER_HOST.
  85.  
  86.    Things to watch for:
  87.  
  88. * all the makefiles in the subdirectories source makeflag.unx via the line
  89.   'include ../makeflag.unx'. If your make support different include structure
  90.   or does not support it at all, you will have to change it or manually
  91.   substitute makeflag.unx content into the subdirectory makefiles.
  92. * Your system must support either X11 or gl. Without graphics you would not
  93.   be able to build the display devices.
  94. * poly3d-r is NOT building under UNIX by default. This is because you need
  95.   another library called gif_lib to link to, and which is not
  96.   provided with this package. You can ftp it separately (see below).
  97.   The poly3d-r renderer renders into 8 bit GIF images and results are
  98.   medium at best. Using the filter IRIT2RAY, use RAYSHADE which is far
  99.   superior and recommended.
  100.  
  101. -----------------------------------------------------------------------------
  102.  
  103. AMIGADOS
  104. --------
  105.  
  106. The Amiga port of Irit 5.0 was tested using SAS/C 6.51 and gcc 2.6.3.
  107. Do not use the optimizer with either compiler.
  108.  
  109. Compiling:
  110.  
  111. You will need GNU make, as well as the programs sh, cp, mv, rm, and echo.
  112. The provided makefiles will not work with SAS's smake.
  113.  
  114. Make sure you have a big enough stack. (I used 50000 bytes successfully,
  115. but had crashes with 20000.) The cp program used by the makefiles
  116. requires lots of stack.
  117.  
  118. Compiling with SAS/C:
  119.  
  120. Edit makeflag.sas, and modify the following assignments:
  121. SRC_DIR    = Put the name of the top level irit directory.
  122. CFLAGS    = Modify the CPU= and MATH= options according to what CPU you
  123.       have and what kind of floating point math you want to use.
  124.       Add the OPTIMIZE flag at your own risk.
  125. MATHLIB = Put the name of the math library with which you want to link.
  126.  
  127. Type make -f makefile.sas at the top directory, and go for a cup of
  128. coffee. When you return, all the binaries will be in the bin
  129. subdirectory.
  130.  
  131. Compiling with gcc:
  132.  
  133. Edit makeflag.ami, and modify the following assignments:
  134. SRC_DIR  = Put here the name of the top level irit directory.
  135. CPUFLAGS = Add the appropriate options for your CPU type and preferred
  136.        math option. Add the -O flag at your own risk.
  137.  
  138. Type make -f makefile.sas at the top directory, and go for a cup of
  139. coffee and a sandwitch. When you return, all the binaries will be in the
  140. bin subdirectory.
  141.  
  142. Because of the large number of <proto/*> files it includes, amidrvs.c
  143. plenty of memory to compile. If you don't have enough, or you can't use
  144. a virtual memory manager, e.g. VMM, you will have to modify amidrvs to
  145. include the corresponding <clib/*> prototypes, link it with libamiga.a
  146.  
  147. Differences between UNIX and Amiga Irit:
  148.  
  149. None to speak of. There is no IRIT_SERVER_HOST environment variable, and
  150. IRIT_SERVER_PORT points to the name of an Exec port rather than to
  151. whatever it is that it points to in UNIX.  When amidrvs is displaying an
  152. animation, the "Animate" button turns into a "Stop Anim" button; hit it
  153. to stop the animation.  If you run amidrvs by hand, be sure to run it
  154. after Irit starts looking for it. Yes, I know that the synchronization
  155. code between Irit and amidrvs is an awful kludge, but since it works,
  156. I'm in no particular hurry to fix it.
  157.  
  158. Bugs:
  159. Quitting from amidrvs while Irit is running, will cause Irit to hang.
  160.  
  161. Bug reports:
  162. If you think you've found a bug in the Amiga port (as opposed to a bug
  163. in Irit itself), send mail to kyrimis@theseas.ntua.gr.
  164.  
  165. -----------------------------------------------------------------------------
  166.  
  167. WINDOWS NT
  168. ----------
  169.  
  170.    Edit the file makeflag.wnt in the main directory.
  171. Set all the variables to the correct path you would like the include
  172. files/libraries/binaries to be installed to.
  173.    Type 'nmake -f makefile.wnt' (namke is Microsoft's make provided with
  174. the SDK of Window NT 3.1). This should build the libraries
  175. (misc/cagd/prsr/graf) following by all the tools including the solid
  176. modeler itself - IRIT.
  177.  
  178.    Once everything built, change directory to the binaries directory. Edit
  179. all *.cfg configuration files and follow the instructions in them to configure
  180. the programs to your system.
  181.    On line help is saved in irit.hlp and is copied to the binaries
  182. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  183. to get a hardcopy manual for IRIT. Alternatively print 'irit.doc' which is
  184. a similar but plain text file.
  185.  
  186.    Each of the subdirectories illustrt/filters/poly3d-r/poly3d-h has a batch
  187. file called test-os2.cmd. Run them to test your new executables.
  188.    Note you will need a gif viewer for poly3d-r images and that test-os2.cmd on
  189. poly3d-h do require ???drvs display device executable to display the hidden
  190. line removed results.
  191. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  192. There are quite a few other .irt files in that directory you may want to try.
  193. Make sure the IRIT_PATH environment variable is properly set as well as
  194. IRIT_DISPLAY. Optional are IRIT_SERVER_HOST and IRIT_SERVER_PORT as described
  195. in the manual.
  196. You can run all these tests by executing 'make -f makefile.os2 test' from
  197. the main directory.
  198.  
  199.    Things to watch for:
  200.  
  201. * all the makefiles in the subdirectories source makeflag.unx via the line
  202.   'include ../makeflag.os2'. If your make support different include structure
  203.   or does not support it at all, you will have to change it or manually
  204.   substitute makeflag.unx content into the subdirectory makefiles.
  205. * poly3d-r requires gif_lib (see below) to build, a library that is not
  206.   provided with this package. You can ftp it separately (see below).
  207.   The poly3d-r renderer renders into 8 bit GIF images and results are
  208.   medium at best. Using the filter IRIT2RAY, use RAYSHADE which is far
  209.   superior and recommended.
  210.  
  211. -----------------------------------------------------------------------------
  212.  
  213. The intr_lib sources can be ftped from the following two places:
  214.  
  215. 1. wuarchive.wustl.edu. directory mirrors/msdos/irit/intrlib?.zip
  216. 2. simtel20.arpa.mil, directory PD:<MSDOS.IRIT> as intrlib?.zip
  217. where ? is the current version.
  218.  
  219. libintr.a (DJGPP) and intr_lib.lib (MSDOS) are built from this package.
  220.  
  221. -----------------------------------------------------------------------------
  222.  
  223. The gif_lib sources can be ftped from the following two places:
  224.  
  225. 1. wuarchive.wustl.edu. directory mirrors/msdos/gif/giflib??.zip
  226. 2. simtel20.arpa.mil, directory PD:<MSDOS.GIF> as giflib??.zip
  227. where ?? is the current version.
  228.  
  229. libgif.a (UNIX) and gif_libl.lib (MSDOS) are built from the lib subdirectory
  230. of giflib??.zip package.
  231.  
  232.